home *** CD-ROM | disk | FTP | other *** search
/ Crossword Puzzles / Crossword Puzzle.iso / puzzlex / puzzlex.doc < prev    next >
Text File  |  1996-09-15  |  21KB  |  506 lines

  1.     PuzzLex (copyright 1993/94)
  2.  
  3.     STATEMENT OF WARRANTY
  4.  
  5.         This software is provided to you as is. The author makes no
  6.         warranty that PuzzLex is suitable for any purpose. Under no
  7.         circumstances will the author be held responsible for any loss or
  8.         damage suffered by any user arising out of the supply, use or
  9.         operation of this software, whether or not such loss or damage be
  10.         direct, consequential or otherwise.
  11.  
  12.  
  13.         PuzzLex aids in solving crosswords and other types of word
  14.         puzzles. It is easy to use but also flexible and powerful in its
  15.         ability to search through the supplied dictionary to suggest
  16.         solutions.
  17.  
  18.         BRIEF SUMMARY OF FEATURES:
  19.  
  20.         185,000 word list. Compressed to save your disc space.
  21.         (Evaluation version 39,000c).
  22.  
  23.         Ability to search for words of between 1 to 15 characters.
  24.  
  25.         Permits searches for Anagrams and Word Patterns.
  26.  
  27.         Flexible searching, supporting 2 types of wildcards:
  28.  
  29.                 ? represents a single unknown character
  30.                 * represents zero or more unknown characters
  31.  
  32.         A complex search option which allows you detailed control over
  33.         your search criteria.
  34.  
  35.         The ability to save words to a supplementary dictionary for future
  36.         searches.
  37.  
  38.         The ability to solve multiple word anagrams.
  39.  
  40.          Context sensitive help.
  41.  
  42.  
  43.  
  44.  
  45.         To run the program type PuzzLex at the DOS prompt.  Users of Mono
  46.         monitors may find the screen colours clearer if they use the mono
  47.         switch invoked by running the program with the command:
  48.  
  49.         puzzlex /m
  50.  
  51.         Users using a Mono VGA screen should use the following command to
  52.         select colours most suitable for this type of screen:
  53.  
  54.         puzzlex /g
  55.  
  56.         In most cases these switches will not be necessary as PuzzLex will
  57.         attempt to determine the type of monitor on which it is running
  58.         automatically.
  59.  
  60.  
  61.         IMPORTANT
  62.  
  63.         If you wish to use the multiple word search options
  64.         described below you must have the files command in
  65.         your config.sys file set to 20
  66.  
  67.                 files=20
  68.  
  69.         If you are running windows then I recommend that this be
  70.         set to 40
  71.  
  72.                 files=40
  73.  
  74.  
  75.         RUNNING PUZZLEX FROM WINDOWS
  76.  
  77.         Although PuzzLex is a DOS program it is quite happy being
  78.         run from MS WINDOWS. To install PuzzLex on your desktop:
  79.  
  80.         Run the File Manager program from WINDOWS and select the
  81.         directory where you have just installed PuzzLex. Position
  82.         the File Manager window such that you can see the files in
  83.         the PuzzLex directory and also see the group icon where you
  84.         wish PuzzLex to be held. Click on the file PuzzLex.exe and
  85.         drag it to the appropriate group icon. Release the file and
  86.         PuzzLex will now be runnable as a DOS program from that
  87.         group.
  88.  
  89.         To assign the PuzzLex item an icon, click on the PuzzLex item
  90.         once, such that it is highlighted, NOT RUN. Click on the File
  91.         option of Program Manager and then select properties.  Select
  92.         Change Icon and then the Browse option. Move to the PuzzLex
  93.         directory and you will see an icon displayed called
  94.         PuzzLex.ico. Select OK. When you exit the file menu PuzzLex
  95.         will now have its new icon.
  96.  
  97.         KEYS:
  98.  
  99.         When entering word patterns or text into PuzzLex the
  100.         following editing keys are available:
  101.  
  102.         Left Cursor         One character left
  103.         Right Cursor        One character right
  104.         Home                Beginning of input field
  105.         End                 End of input field
  106.         Insert              Toggle between insert and overstrike
  107.         Delete              Delete character under cursor
  108.         Backspace           Delete character to left of cursor
  109.         Return              Accept input and continue.
  110.         Cntrl End           Delete input field
  111.         Up Cursor           Previous input field (When applicable)
  112.         Down Cursor         Next input field (When applicable)
  113.         Cntl Down Cursor    Recall last word pattern
  114.  
  115.         You can jump to the various search pages directly without
  116.         returning to the main menu by selecting one of the following key
  117.         combinations:
  118.  
  119.         Alt-a           Goto Anagram Search Screen
  120.         Alt-p           Goto Word Pattern Search Screen
  121.         Alt-c           Goto Complex Pattern Search Screen
  122.         Alt-n           Add a word to the user dictionary
  123.         Alt-f           Send the words found by PuzzLex to a file for
  124.                         later examination
  125.  
  126.         !               This character has a special significance
  127.                         and can only be entered into the Pattern
  128.                         field on the Complex Search Screen. When
  129.                         used it tells PuzzLex to break the letters
  130.                         entered in the Source field into every possible
  131.                         combination of words that it can find.
  132.  
  133.                         eg
  134.  
  135.                         Pattern:        !
  136.                         Source:         margaretthatcher
  137.  
  138.                         Would list all the possible combinations of 
  139.                         words that can be made from margaretthatcher.
  140.  
  141.                         BE WARNED this option will typically result in 
  142.                         thousands of solutions.
  143.  
  144.        When completing a PATTERN field you can enter a number to represent 
  145.        a number of consecutive ?s
  146.  
  147.         eg  a4t       Would be treated as a????t
  148.             5y2       Would be treated as ?????y??
  149.     
  150.         THE MAIN MENU
  151.  
  152.         When PuzzLex is started you will initially be presented with a
  153.         simple menu that gives access to the various types of searches
  154.         available within PuzzLex and the option to add your own words to
  155.         the user dictionary.
  156.  
  157.         To select a screen simply press the numeric key associated with
  158.         your choice or press the highlighted letter key, the menu will
  159.         then be replaced by the relevant search screen where you can
  160.         specify your search criteria. Each of these screens is described
  161.         in the following sections.
  162.     
  163.         ANAGRAMS:
  164.  
  165.         At the Pattern prompt type in the anagram and press enter, all
  166.         matching words will be displayed on the screen. The search can be
  167.         abandoned by pressing the escape key.
  168.  
  169.     Example 1
  170.  
  171.         Entering the letters ragden would list the following matches:
  172.  
  173.          gander     garden  ranged  danger
  174.  
  175.         Searches can be given additional flexibility by using wildcards.
  176.         PuzzLex supports two wild card characters: ? and *. The ?
  177.         represents any single character and * represents zero or more
  178.         characters.
  179.  
  180.  
  181.     Example 2
  182.  
  183.          ?rgden would list the following matches:
  184.  
  185.         gander  garden  ranged  danger  gerund ringed  gender
  186.  
  187.  
  188.     Example 3
  189.  
  190.         *rgden would list all words of 5 or more letters that contain the
  191.         letters rgden
  192.  
  193.     Example 4
  194.  
  195.         *???? would list all words of 4 or more letters. The four question
  196.         marks tell PuzzLex that the words found must contain four letters
  197.         and the * add zero or more letters to valid solutions.
  198.     
  199.         WORD PATTERNS:
  200.  
  201.         This option allows you to find solutions to incomplete words and
  202.         is extremely useful in solving those last few crossword clues. To
  203.         use this option simply type in the incomplete word representing
  204.         any unknown letters with a ? the program will quickly list all
  205.         matching words.
  206.  
  207.     Example 1
  208.  
  209.         c?o??w?r? would list the following matches:  clockwork
  210.         crossword
  211.  
  212.         Once again the search can be given additional flexibility by using
  213.         the * wildcard. searches:
  214.  
  215.     Example 2
  216.  
  217.         c?o??w?r*  would list:  clockwork    crossword   clockworks
  218.         crosswords
  219.  
  220.     Example 3
  221.  
  222.         *a*e*i*o*u* would list all words that contain the vowels in
  223.         alphabetic order.
  224.  
  225.     Example 4
  226.  
  227.         *u*o*i*e*a*    Would list all words that contain the vowels in
  228.         reverse alphabetic order.
  229.  
  230.     Example 5
  231.  
  232.         *   Would list all words in the dictionaries.
  233.  
  234.     Example 6
  235.  
  236.         ?????   Would list all 5 letter words.
  237.  
  238.     Example 7
  239.  
  240.         ?a????r Would list all 7 letter words where the 2nd letter is 'a'
  241.         and the 7th is 'r'.
  242.  
  243.     Example 8
  244.  
  245.         ?????*  Would list all words of 5 letters or more
  246.     
  247.         COMPLEX SEARCHES
  248.  
  249.         The complex search option has been designed to allow you more
  250.         control over your search criteria.  When selecting this option
  251.         you are presented with a dialogue box in which you can specify
  252.         how you wish your search to be carried out. Below is a description
  253.         of the various types of search criteria that can be used.
  254.  
  255.         Pattern:This field must be completed. It provides the target
  256.                 pattern that all matched words must conform to. If this
  257.                 field is the only one completed then PuzzLex will be
  258.                 performing a Pattern search in exactly the same way as
  259.                 done if using the Word Pattern search screen. Once again
  260.                 wildcards may be used to increase flexibility, see the
  261.                 Word Pattern description above for further details.
  262.  
  263.         The other options all allow you to exercise greater control on
  264.         what words will be deemed to have matched the pattern.
  265.  
  266.         Source: The source field allows you to specify up to 40 letters of
  267.                 which matched words must be comprised. If this field is
  268.                 used PuzzLex will first find a match to your pattern, once
  269.                 it has found a matching word it will then examine your
  270.                 Source field to check that the found word can be made from
  271.                 the supplied source, before the word is displayed as a
  272.                 valid solution.
  273.  
  274.                 The case of the letters in the source is also significant.
  275.                 If a letter is entered in lower case then it can be used
  276.                 only once, you can enter the letter twice to allow for
  277.                 words that contain two occurrences of that letter. If the
  278.                 letter is entered in upper case then PuzzLex will be free
  279.                 to re-use that letter as many times as it needs to find a
  280.                 valid solution.
  281.  
  282.                 The following examples should make this clearer.
  283.  
  284.     Example 1
  285.  
  286.         Pattern: ????* Source: nouctwodn
  287.  
  288.         Will list all words of 4 or more letters that can be found in the
  289.         given source. This option can be used to play Channel 4's
  290.         Countdown quiz. It can also be helpful in solving some crossword
  291.         clues where you suspect that the answer is hidden in the clue.
  292.         Just enter the required pattern and type the clue or phrase into
  293.         the source, the program will list all the words that match the
  294.         pattern and that can be made from the letters supplied in the
  295.         source
  296.  
  297.     Example 2
  298.  
  299.         Consider the puzzle 'What is the largest word you can make using
  300.         only the top row of the keyboard, i.e. the letters qwertyuiop'? If
  301.         you were to enter '*' in the pattern field signifying that you
  302.         require all words and qwertyuiop in the source field the largest
  303.         word returned would be wipeout.  As PuzzLex is only using each
  304.         letter once it fails to solve the problem satisfactorily. However
  305.         if you entered QWERTYUIOP in the source field PuzzLex is free to
  306.         reuse the letters as necessary and finds more solutions which
  307.         include amongst others the well known solution, typewriter.
  308.  
  309.         Include:Allows you to specify letters that must be included in
  310.                 the matched words. Some puzzles require you to supply a
  311.                 list of words that can be made from a given source but
  312.                 which must contain a specific letter.
  313.  
  314.                 Pattern:    ????* 
  315.                 Source:     fgoiblenu 
  316.                 Include:    b
  317.  
  318.                 Will list all words of 4 or more letters containing a 'b'
  319.                 that can be made using the letters provided in source.
  320.  
  321.  
  322.         Exclude: Is the converse of Include and permits you to exclude
  323.                  all words containing the specified letter or
  324.                  letters.
  325.  
  326.     Example 3
  327.  
  328.         How many words can you think of that do not include any of the
  329.         vowels: aeiou? To solve this problem enter the following search
  330.         criteria
  331.  
  332.         Pattern:    '*' indicating that you want all words Exclude:
  333.         aeiou
  334.  
  335.         After you press the F10 key PuzzLex will return all the matching
  336.         words that do NOT contain any of the letters 'aeiou'.
  337.     
  338.         MULTIPLE WORD SEARCHES
  339.  
  340.         So far we have described the Complex Search page in relation to
  341.         single word solutions to a given set of search criteria. A new
  342.         feature of PuzzLex v2.0 is the ability to solve multiple word
  343.         anagram problems. Suppose you had the following crossword clue:
  344.  
  345.         erect smartish breaks festive shrub     9,4
  346.  
  347.         The solution is an anagram of  'erect smartish'  as indicated 
  348.         by the word 'breaks'. Looking at your crossword grid suppose 
  349.         you have the following entry for this clue:  ?h??s??????e?
  350.  
  351.         To solve the problem using PuzzLex first enter the required 
  352.         pattern into the pattern field on the examples Search page.  
  353.         Separate each pattern by a space. Using the above example 
  354.         your pattern would be: '?h??s????  ??e?'. Now enter in the 
  355.         Source Field the letters you believe make up the anagram:  
  356.         'erectsmartish'.  Press the F10 key and a small window will 
  357.         pop-up asking you to wait while PuzzLex analyses its 
  358.         dictionary. When this is completed the possible solutions 
  359.         to the problem will be displayed.
  360.  
  361.         christmas reet    christmas tree
  362.  
  363.     The answer is of course christmas tree.
  364.  
  365.         When you entered your pattern in the above example and pressed
  366.         return you would have seen the fields change from those normally
  367.         displayed. The Exclude and Include fields were removed and a 
  368.         new field 'Use All Source' was displayed.
  369.  
  370.  
  371.         USE ALL SOURCE
  372.  
  373.         This setting can be either ON or OFF. When on, the input field 
  374.         is marked with an X. Pressing the space bar will change the 
  375.         state of the field. The setting of this field will change the 
  376.         way PuzzLex determines whether it has a valid solution.  If not 
  377.         set then PuzzLex will check any potential solutions to your 
  378.         pattern against the source. If they can be found in the source 
  379.         then the solution is deemed good and the solution displayed. If 
  380.         the field has been marked then any found solution must use all 
  381.         of the source in order to be deemed as valid solution.
  382.  
  383.         This can be more clearly explained by way of an example. Consider
  384.         the following:
  385.  
  386.         Pattern:        * * 
  387.         Source:         onetwo 
  388.         Use All Source:
  389.  
  390.         If you leave the 'Use All Source' field clear and press F10 then
  391.         amongst many solution you will see is 'no to'. This satisfies the
  392.         pattern which specifies two words of zero or more letters and 'no
  393.         to' can be found in the Source. However if you now mark the 
  394.         'Use All Source' field and repeat the search 'no to' is not 
  395.         returned as a solution because it did not use all the Source, 
  396.         instead all the solutions contain a total of 6 letters as 
  397.         specified in the Source.
  398.  
  399.  
  400.         NO PERMUTATIONS
  401.  
  402.         When you entered the above Pattern: '* *' and pressed [RETURN] not
  403.         only was the field 'Use All source' displayed but a new field 'No
  404.         Permutations' was also shown. This field works in the same way as
  405.         the 'Use All Source' field and can be either marked on or off. If
  406.         this field has been marked then permutations of the same solutions
  407.         will be suppressed by PuzzLex. If  you consider the above example
  408.         then both 'one two' and 'two one' would be valid solutions. If the
  409.         'No Permutation' field was marked then only 'one two' would be
  410.         displayed.  Selecting this option will speed up the search and
  411.         reduce the amount of output displayed.
  412.  
  413.         NB   The 'No Permutations' field is only available for multiple
  414.              word patterns that are totally wild, i.e. consist
  415.              solely of the '*' wildcard.
  416.  
  417.  
  418.         In addition to solving crossword anagram problems the multiple,
  419.         anagram feature of PuzzLex can be put to amusing use by applying
  420.         it to a relative's or a friend's name. I have added a special
  421.         pattern character to make this easier. If the '!' mark is placed
  422.         in the pattern field then PuzzLex will break the supplied Source
  423.         field into every combination of words that it can find.  The
  424.         burden placed on the computer when performing a search like this
  425.         is immense. I would recommend using the 'No Permutations' option
  426.         when performing these types of searches and sending the output to
  427.         a file for future examination. Alternatively you could request a
  428.         specific number of words from the supplied name as shown below.
  429.  
  430.         To find all the three word combinations that can be made from my
  431.         own name I would enter the following search criteria:
  432.  
  433.         Pattern:                * * * 
  434.         Source:                 nevillebentley 
  435.         Use All Source:         X 
  436.         No Permutations:        X
  437.     
  438.         SEND OUTPUT TO FILE
  439.  
  440.         New to version 2.0 is the facility to send PuzzLex's output to a
  441.         specified file as plain ASCII text that can be read by most
  442.         editors or word processors. This option is selected by pressing
  443.         the keys ALT and f simultaneously at any of the search screens
  444.         (the option is not available from the main menu).
  445.  
  446.         When you select this option a window will pop-up in which you can
  447.         specify the filename you wish the output to be sent. Simply enter
  448.         the filename with a path if required and press [RETURN]. When you
  449.         start the search the solutions will be written to the file and
  450.         echoed to the screen. If output is being sent to a file then
  451.         PuzzLex will NOT pause at each full screen of solutions.
  452.  
  453.         If you select a file that already exists then you will be warned
  454.         and given the choice of overwriting the existing file or choosing
  455.         another filename.
  456.  
  457.         The output to file option only lasts for a single search, it must
  458.         be re-selected for subsequent searches.
  459.     
  460.         ADD NEW WORD
  461.  
  462.         PuzzLex allows you to add additional words to its dictionary by
  463.         selecting the 'Add New Word' option from the Main Menu or by
  464.         pressing ALT-N while in any of the search screens. When this
  465.         option has been selected you are presented  with a pop-up window
  466.         that allows you to enter the word to be added. Simply type in the
  467.         new word and press [RETURN], the word will now be used by PuzzLex
  468.         in all future searches. If the word already exists in PuzzLex's
  469.         main dictionary you will be warned of the fact and the word will
  470.         not be added.
  471.  
  472.         Any words added using this option are actually added to a
  473.         supplementary file called puzzlex.usr in your PuzzLex directory.
  474.         This file is a simple ASCII format and can be viewed and edited
  475.         with most editors or word processors. I do not recommend that you
  476.         alter the order in which words are stored in this file but you
  477.         may remove any words that have been added incorrectly.
  478.     
  479.         HELP PUZZLEX TO DEVELOP
  480.  
  481.         If you have any ideas as to how PuzzLex can be improved or feel
  482.         there are any particular areas of weakness please let me know and
  483.         I will try to incorporate your ideas in any future releases.
  484.  
  485.  
  486.         HELP TO IMPROVE THE PUZZLEX DICTIONARY.
  487.  
  488.         Although I have tried to provide PuzzLex with as 
  489.         comprehensive dictionary as possible I'm sure you will, 
  490.         from time to time, find words that are not included, 
  491.         afterall that is why I have included the 'Add New Word' 
  492.         option. If you build up a user dictionary of such words why 
  493.         not copy it to a floppy disc and send it to me. I can then 
  494.         incorporate these additional words into the main dictionary 
  495.         and return your disc with the new dictionary including your 
  496.         words and any others supplied by other users.  Please include 2
  497.         first class stamps with your disc to cover my costs.
  498.  
  499.  
  500.         Thank you for registering PuzzLex, your support is greatly
  501.         appreciated.
  502.  
  503.  
  504.     Neville Bentley
  505.  
  506.